home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / program / pmw123.zip / UTILS.DOC < prev   
Text File  |  1996-06-24  |  12KB  |  259 lines
  1. ------------------------------------------------------------------------------
  2. --------------------------- Utilities for PMODE/W ----------------------------
  3. ------------------------------------------------------------------------------
  4.  
  5.   This is the documentation for the PMODE/W v1.23 utilities PMWSETUP, PMWBIND,
  6. PMWLITE, and PMWVER. These utilities are Copyright (c) 1995-1996, Charles
  7. Scheffold and Thomas Pytel. All rights reserved.
  8.  
  9. Contents:
  10. ---------
  11.  
  12. 1 - PMWSETUP
  13.     1.0 - Description
  14.     1.1 - PMODE/W Parameters
  15.     1.2 - Editing
  16.  
  17. 2 - PMWBIND
  18.     2.0 - Description
  19.     2.1 - Commands
  20.     2.2 - Switches
  21.  
  22. 3 - PMWLITE
  23.     3.0 - Description
  24.     3.1 - Switches
  25.  
  26. 4 - PMWVER
  27.     4.0 - Description
  28.  
  29. ------------------------------------------------------------------------------
  30. ---------------------------------- PMWSETUP ----------------------------------
  31. ------------------------------------------------------------------------------
  32.  
  33. 1.0 - Description:
  34. ------------------
  35.  
  36.   PMWSETUP is a program which will allow you to modify the various PMODE/W
  37. parameters which affect the way it executes. You may modify these parameters
  38. within any program which uses PMODE/W. Or you may edit them within the PMODE/W
  39. extender itself, where they will be passed on to any program compiled with
  40. that modified version of PMODE/W. The syntax for PMWSETUP is as follows:
  41.  
  42.   PMWSETUP <filename>
  43.  
  44. where <filename> is the path name of the executable you wish to modify or
  45. "PMODEW.EXE" itself.
  46.  
  47. 1.1 - PMODE/W Parameters:
  48. -------------------------
  49.  
  50.   For a more detailed explanation of these parameters, see the PMODE/W
  51. documentation. Minimums and maximums will be enforced by the PMWSETUP program
  52. for the settings, but you must still make sure that the values you set are
  53. appropriate for your program. The parameters are as follows:
  54.  
  55. ) Number of VCPI Page Tables:
  56.  
  57.     This parameter specifies the maximum number of page tables allowed under a
  58.   VCPI server. For each page table used at run time, 4k of low memory is used
  59.   by PMODE/W.
  60.  
  61. ) VCPI/XMS/raw Max Selectors:
  62.  
  63.     This parameter specifies the number of selectors that PMODE/W will make
  64.   available when a DPMI host is not in place. PMODE/W needs only 8 bytes of
  65.   low memory for each selector, so you may set high values for this parameter.
  66.  
  67. ) Real Mode Stack Length:
  68.  
  69.     This parameter specifies the length of the real mode stack provided by
  70.   PMODE/W to real mode interrupt or IRQ calls. The size is in paragraphs.
  71.   PMODE/W allocates low memory for real mode stacks when it initializes, and
  72.   that memory can not be used for anything else.
  73.  
  74. ) Protected Mode Stack Length:
  75.  
  76.     This parameter specifies the length of the protected mode stack provided
  77.   by PMODE/W to real mode callbacks to protected mode or protected mode IRQ
  78.   handlers issued during real mode processing. The size is in paragraphs.
  79.   PMODE/W allocates low memory for protected mode stacks when it initializes,
  80.   and that memory can not be used for anything else.
  81.  
  82. ) Real Mode Stack Nesting:
  83.  
  84.     This parameter specifies the maximum number of nested real mode stacks
  85.   that PMODE/W will provide. PMODE/W will allocate this number of real mode
  86.   stacks when it initializes. So for example, 8 stacks at 40h paragraphs each
  87.   will allocate a total of 8k for real mode stacks.
  88.  
  89. ) Protected Mode Stack Nesting:
  90.  
  91.     This parameter specifies the maximum number of nested protected mode
  92.   stacks that PMODE/W will provide. PMODE/W will allocate this number of
  93.   protected mode stacks when it initializes. So for example, 8 stacks at 80h
  94.   paragraphs each will allocate a total of 16k for protected mode stacks.
  95.  
  96. ) Number of Real Mode Callbacks:
  97.  
  98.     This parameter specifies the maximum number of DPMI real mode callbacks
  99.   that PMODE/W will provide when a DPMI host is not in place. PMODE/W needs
  100.   25 bytes of low memory per callback, which is allocated during
  101.   initialization.
  102.  
  103. ) VCPI/DPMI Detection Mode:
  104.  
  105.     This parameter specifies the order of detection for VCPI and DPMI. This
  106.   allows for detection and use of VCPI for speed under a system that supports
  107.   both DPMI and VCPI.
  108.  
  109. ) Maximum Extended Memory to Allocate:
  110.  
  111.     This parameter specifies the maximum amount of extended memory for PMODE/W
  112.   to allocate from the system. The size is in bytes. Specifying a lower value
  113.   for this parameter than there is extended memory in the system will force
  114.   PMODE/W to leave some extended memory free for use by other extenders and
  115.   programs that use XMS and EMS. Your program will not necessarily have this
  116.   much extended memory available to it due to other PMODE/W and Watcom C/C++
  117.   system requirements for extended memory.
  118.  
  119. ) Low Memory to Reserve:
  120.  
  121.     This parameter specifies the minimum amount of low memory for PMODE/W to
  122.   reserve for the program. PMODE/W will try to preserve this low memory by
  123.   loading 32 bit code and data into extended memory if it can, but the memory
  124.   is not guaranteed to be available. Setting this parameter to a very high
  125.   value ensures PMODE/W will leave as much low memory free as possible.
  126.  
  127. ) Maximum Physical Address Mapping Page Tables:
  128.  
  129.     This parameter specifies the maximum number of page tables to be made
  130.   available by PMODE/W under VCPI for physical address mapping. PMODE/W needs
  131.   4k of extended memory for each page table for address mapping.
  132.  
  133. ) Display Copyright Message At Startup:
  134.  
  135.     This parameter is checked by PMODE/W at startup in order to decide whether
  136.   or not the copyright message is displayed during initialization.
  137.  
  138. 1.2 - Editing:
  139. --------------
  140.  
  141.   While in PMWSETUP, the arrow keys move the selection bar, SPACE toggles
  142. hex/decimal display, and ENTER allows you to enter a new value for the
  143. currently selected parameter. PMWSETUP will not allow you to exceed the
  144. minimum or maximum values for the parameters, but common sense must also be
  145. used when assigning very low or high settings. When you are done modifying the
  146. parameters, you may save your changes. If you decide not to make any changes,
  147. you may abort, and any parameters you have modified will not be written to the
  148. file you are editing.
  149.  
  150. ------------------------------------------------------------------------------
  151. ---------------------------------- PMWBIND -----------------------------------
  152. ------------------------------------------------------------------------------
  153.  
  154. 2.0 - Description:
  155. ------------------
  156.  
  157.   PMWBIND is a program which binds and unbinds stub programs to and from
  158. protected mode LE executable files (the file format used by DOS/4GW, and
  159. PMODE/W). This allows you to replace older versions of PMODE/W within an
  160. executable file with newer ones. It also allows you to turn a DOS/4GW,
  161. DOS/4GW PRO, or DOS/4G PRO program into a PMODE/W program very easily just by
  162. replacing the stub. This practice in not really suggested though since you do
  163. not know if the program in question uses any DOS/4G specific functions which
  164. will not work with PMODE/W. But in general, many programs are completely
  165. portable from DOS/4GW to PMODE/W with little or no tweaking of the PMODE/W
  166. parameters. PMWBIND will not allow you to bind or unbind a compressed
  167. protected mode PMODE/W executable due to the fact that it is not an ordinary
  168. LE executable and it would really serve no point. The syntax for PMWBIND is
  169. as follows:
  170.  
  171.   PMWBIND <command> [options] <filename>
  172.  
  173. where <command> is the operation you want to perform (bind, unbind, or
  174. replace), [options] are various options, and <filename> is the path name of
  175. the program you wish to modify.
  176.  
  177. 2.1 - Commands:
  178. ---------------
  179.  
  180. ) /B - Bind PMODE/W (or specified stub) to an unbound LE executable file.
  181. ) /U - Unbind the stub from a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  182.        executable file.
  183. ) /R - Replace the stub of a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  184.        executable file.
  185.  
  186. 2.2 - Switches:
  187. ---------------
  188.  
  189. ) /D<filename> - Use <filename> for destination of bound or unbound executable
  190.                  instead of default.
  191. ) /N           - Suppress output of executable file (used